Custom Commands

You also have the option to craft your own personalized commands. These custom commands empower you to design commands specifically suited to your channel and its community. With custom commands, you can devise distinctive interactions and functionalities.

Creating a Custom Command

Simply head over to the Commands Section in the Dashboard and click on the "+" button in the bottom right. From there, you can customize your command to your liking.

Custom Command Setup

Name

Enter the name of your command. This is what users will type to trigger the command. Commands are case-insensitive. Every command will be prefixed with the command prefix, which is !.

Enabled

You can enable or disable your command at any time. This allows you to keep the command without having to delete it.

Shortcuts

You can add multiple shortcuts to a command. This is useful if you want to use a command without typing the full command name.

• Example: !testing -> !t
• You can add multiple shortcuts to a command

User Level

Choose the minimum User Level required to trigger the command:

• Everyone: All chatters.
• Subscribers: Subscribers, moderators, and the streamer.
• Moderators: Moderators and the streamer.
• Streamer: Only the channel owner.

Cooldown

Enter the cooldown for your command. This is the amount of time a user must wait before using the command again. The cooldown is in minutes. You and your moderators are exempt from the cooldown.

Text

This is the response that the bot will give when the command is triggered. Empty lines are supported.

Multiple Command Texts

Commands can have multiple response texts. This allows you to provide varied responses each time the command is used, making interactions more engaging and less repetitive.

Adding Multiple Texts:

• Use the "+" button next to the text label to add additional response texts
• Navigate between texts using the arrow buttons
• Remove texts with the "-" button (at least one text is required)

Selection Modes:

• Random: The bot randomly selects one of the texts each time the command is used
• Sequential: The bot cycles through the texts in order, remembering where it left off

Variables

You can use the following variables in your command text:

• {user} - The username of the user who triggered the command
• {random X-Y} - A random number between X and Y (inclusive)
• {random.number X-Y} - Alternative syntax for random numbers
• {random.pick 'option1' 'option2' 'option3'} - Randomly selects one option from the list
• $(args) - All arguments after the command name joined by spaces
• $(1), $(2), $(3), $(n) (any number) - Individual arguments by position (blank if missing)

Variable Examples

• {user} rolled a {random 1-6}! - Outputs: "Alice rolled a 4!"
• The winner is: {random.pick 'red team' 'blue team' 'green team'} - Outputs: "The winner is: blue team"
• {user} scored {random 50-100} points! - Outputs: "Bob scored 73 points!"
• Multiple variables: {user} picked {random.pick 'rock' 'paper' 'scissors'} and rolled {random 1-20}
• Hello $(1) with input !hello World outputs Hello World
• `

Notes:

• Quotes in random.pick can be either single (') or double (") quotes
• Random number ranges are limited to a maximum span of 10,000
• Invalid syntax will leave the variable unchanged in the output

Multiple Texts Example

Here's an example of how to create a dice roll command with multiple response variations:

Command Name: !dice

Texts (Random mode):

1. {user} rolled a {random 1-6}! 🎲
2. 🎯 {user} got a {random 1-6}!
3. The dice shows... {random 1-6}! Nice roll, {user}!
4. {user} throws the dice... It's a {random 1-6}!

Each time someone uses !dice, they'll get a different response format, making the command more entertaining!

Sequential Mode Example:

For a daily tip command, you might want tips to appear in order:

Command Name: !tip

Texts (Sequential mode):

1. #1: Remember to stay hydrated during long streams!
2. #2: Don't forget to show some love by tipping!
3. #3: Please follow me on Twitch!
4. #4: Visit my profile page for more content!

The bot will cycle through these tips in order, showing Tip #1, then Tip #2, and so on.

Testing Your Custom Command

Simply head over to your channel and type the command you created. The bot will respond with the text you entered.